Crate svgtypes[−][src]

Expand description

svgtypes is a collection of parsers, containers and writers for SVG 1.1 types.

Usage is simple as:

use svgtypes::Path;

let path: Path = "M10-20A5.5.3-4 110-.1".parse().unwrap();
assert_eq!(path.to_string(), "M 10 -20 A 5.5 0.3 -4 1 1 0 -0.1");

You can also use a low-level, pull-based parser:

use svgtypes::PathParser;

let p = PathParser::from("M10-20A5.5.3-4 110-.1");
for token in p {
    println!("{:?}", token);
}

You can also tweak an output format:

use svgtypes::{Path, WriteBuffer, WriteOptions};

let path_str = "M10-20A5.5.3-4 110-.1";
let path: Path = path_str.parse().unwrap();

let opt = WriteOptions {
    remove_leading_zero: true,
    use_compact_path_notation: true,
    join_arc_to_flags: true,
    .. WriteOptions::default()
};

assert_eq!(path.with_write_opt(&opt).to_string(), path_str);

Supported SVG types

SVG Type	Rust Type	Storage	Parser
<color>	Color	Stack
<number>	f64	Stack
<length>	Length	Stack
<angle>	Angle	Stack
<viewBox>	ViewBox	Stack
<path>	Path	Heap	PathParser
<list-of-numbers>	NumberList	Heap	NumberListParser
<list-of-lengths>	LengthList	Heap	LengthListParser
<transform-list>	Transform	Stack	TransformListParser
<list-of-points>	Points	Heap	PointsParser
<paint>	-	-	Paint

All types implement from string (FromStr) and to string traits (Display, WriteBuffer).
The library doesn’t store transform list as is. It will premultiplied.
The paint type can only be parsed.

Benefits

Complete support of paths, so data like M10-20A5.5.3-4 110-.1 will be parsed correctly.
Access to pull-based parsers.
Pretty fast.

Limitations

Accepts only normalized values, e.g. an input text should not contain   or &data;.
All keywords must be lowercase. Case-insensitive parsing is supported only for colors (requires allocation for named colors).
The <color> followed by the <icccolor> is not supported. As the <icccolor> itself.
System colors, like fill="AppWorkspace", are not supported. They were deprecated anyway.
Implicit path commands are not supported. All commands will be parsed as explicit.
Implicit MoveTo commands will be automatically converted into explicit LineTo.